扩展 插件加速两种方法 & 常见插件推荐
插件初始化流程
Jenkins 首次启动后进入初始化向导，有两个选项：
| 选项 | 说明 | 适用场景 |
|---|---|---|
| 安装推荐的插件 | 安装 Jenkins 官方推荐的一批插件 | 第一次使用，不确定需要什么 |
| 选择插件来安装 | 手动勾选所需插件 | 明确需求，或网络不稳定时先装最少插件 |
网络不稳定时的策略：先选择最少插件（如仅中文语言包）完成初始化，进入系统后再通过加速源安装其余插件。可以点选顶部的"无"取消所有默认勾选，再定向选择需要的插件。
方法一：通过管理界面配置加速源
操作路径
Manage Jenkins → Plugins → Advanced settings → Update Site
国内镜像源地址
| 镜像站 | Update Site URL | 说明 |
|---|---|---|
| 清华大学 TUNA（推荐） | https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json | 由清华大学 TUNA 协会维护，稳定性好 |
| 腾讯云 | https://mirrors.cloud.tencent.com/jenkins/updates/update-center.json | 腾讯云 CDN 加速，部分地区速度更快 |
| 华为云 | https://mirrors.huaweicloud.com/jenkins/updates/update-center.json | 华为开源镜像站 |
| Jenkins 中文社区 | https://updates.jenkins-zh.cn/update-center.json | 专为国内用户维护 |
| 阿里云 | https://mirrors.aliyun.com/jenkins/updates/update-center.json | 阿里云镜像站 |
配置步骤
- 进入 Manage Jenkins → Plugins → Advanced settings
- 在 Update Site 区域，将 URL 替换为上述镜像地址
- 点击 Submit 保存
- 进入 Available plugins 搜索并安装插件
重要提醒：部分镜像源（如清华源）仅镜像了
update-center.json元数据文件，JSON 内部的插件下载 URL 仍可能指向jenkins.io官方服务器。这意味着单纯替换 Update Site URL 不一定能完全加速下载。如果发现速度仍然很慢，需要使用方法二来彻底替换下载地址。
方法二：直接修改配置文件（暴力但有效）
如果界面配置加速效果有限，可直接修改 Jenkins 安装目录下的配置文件，将所有下载地址替换为国内镜像。
2.1 修改 hudson.model.UpdateCenter.xml
这是控制 Jenkins 更新源地址的核心配置文件。
| 环境 | 文件路径 |
|---|---|
| Docker（官方镜像） | /var/jenkins_home/hudson.model.UpdateCenter.xml |
| Linux 原生安装 | /var/lib/jenkins/hudson.model.UpdateCenter.xml |
将默认内容：
<?xml version='1.1' encoding='UTF-8'?>
<sites>
<site>
<id>default</id>
<url>https://updates.jenkins.io/update-center.json</url>
</site>
</sites>
xml
替换为清华源：
<?xml version='1.1' encoding='UTF-8'?>
<sites>
<site>
<id>default</id>
<url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>
</site>
</sites>
xml
2.2 修改 default.json 中的下载地址
这一步是彻底加速的关键——将 default.json 中所有指向 jenkins.io 的实际下载链接替换为国内镜像。
# 1. 找到 updates 目录
cd /var/jenkins_home/updates
# 2. 一键替换所有 jenkins.io 下载地址为清华源
sed -i 's|https://updates.jenkins.io/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g' default.json
# 3. 同时替换旧版地址
sed -i 's|http://updates.jenkins-ci.org/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g' default.json
# 4. 替换连接检测地址（可选，解决部分网络环境下的检测问题）
sed -i 's|http://www.google.com|https://www.baidu.com|g' default.json
bash
如果使用腾讯云，将上述命令中的
mirrors.tuna.tsinghua.edu.cn/jenkins替换为mirrors.cloud.tencent.com/jenkins。
也可以用 VS Code 等编辑器手动替换：
查找：updates.jenkins.io/download
替换：mirrors.tuna.tsinghua.edu.cn/jenkins
text
Docker 环境下的完整操作
# 1. 进入 Jenkins 容器
docker exec -it -u root jenkins-blueocean bash
# 2. 修改更新源配置
sed -i 's|https://updates.jenkins.io/update-center.json|https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json|g' /var/jenkins_home/hudson.model.UpdateCenter.xml
# 3. 修改 default.json 中的下载地址
cd /var/jenkins_home/updates
sed -i 's|https://updates.jenkins.io/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g' default.json
sed -i 's|http://updates.jenkins-ci.org/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g' default.json
# 4. 退出后重启 Jenkins
docker restart jenkins-blueocean
bash
Docker Compose 预配置方式
在 docker-compose.yml 中挂载预配置好的 hudson.model.UpdateCenter.xml：
services:
jenkins:
image: jenkins/jenkins:lts
ports:
- "8080:8080"
volumes:
- jenkins_home:/var/jenkins_home
- ./hudson.model.UpdateCenter.xml:/var/jenkins_home/hudson.model.UpdateCenter.xml
restart: always
yaml
排查下载失败
如果插件安装失败，查看 Jenkins 日志：
# 查看日志
docker logs jenkins-blueocean
# 实时跟踪日志
docker logs -f jenkins-blueocean --tail 100
# 测试镜像源连通性
ping mirrors.tuna.tsinghua.edu.cn
curl -I https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
bash
常见问题及解决方案：
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 连接超时 | 镜像源不可达 | ping 或 curl 测试连通性，切换到其他镜像源 |
| 证书校验失败 | HTTPS 证书问题 | 检查 URL 是否以 https 开头，或升级 Jenkins 版本 |
| 插件依赖缺失 | 网络中断导致依赖未下载 | 确保网络通畅后重新安装 |
| 元数据同步延迟 | 镜像源未及时同步最新插件 | 等待同步或切换到 Jenkins 中文社区源 |
Checking internet connectivity 失败 | 网络检测被拦截 | 替换 default.json 中的 google.com 为 baidu.com |
切换源的思路：如果某个镜像源无法使用（如清华源在部分移动网络下可能 ping 不通），果断切换到腾讯云或华为云等其他源。不同网络环境对不同镜像源的访问速度差异较大。
常见插件推荐
核心必装插件
| 插件名称 | 功能说明 | 优先级 |
|---|---|---|
| Git Plugin | Git 代码仓库集成，版本控制基础 | 必装 |
| Pipeline | 流水线引擎，支持 Jenkinsfile 即代码 | 必装 |
| Pipeline: Stage View | Pipeline 各阶段可视化展示 | 必装 |
| Pipeline Graph View | 流水线图形化视图，Blue Ocean 的官方替代 | 强烈推荐 |
| NodeJS Plugin | Node.js 环境管理，支持多版本切换 | 前端项目必装 |
| Localization: Chinese (zh_CN) | Jenkins 界面中文汉化 | 推荐 |
| Credentials Binding | Pipeline 中安全绑定凭证 | 必装 |
关于 Blue Ocean：Blue Ocean 已于 2026 年 7 月正式废弃，不再接收安全更新。官方推荐的替代方案是 Pipeline Graph View 插件，它直接集成到经典 Jenkins UI 中，无需额外的 UI 框架。新建项目建议直接使用 Pipeline Graph View。
权限与安全插件
| 插件名称 | 功能说明 |
|---|---|
| Role-based Authorization Strategy | 基于角色的权限控制（推荐） |
| Matrix Authorization Strategy | 矩阵式细粒度权限管理 |
| GitLab Authentication | 使用 GitLab 账号登录 Jenkins |
| LDAP Plugin | 集成企业 LDAP 目录服务 |
代码仓库集成
| 插件名称 | 功能说明 |
|---|---|
| GitLab Plugin | GitLab Webhook 触发构建、API 集成 |
| GitHub Integration | GitHub PR 状态回写、Webhook 触发 |
| Git Parameter | Pipeline 中动态选择分支/Tag |
构建与部署
| 插件名称 | 功能说明 |
|---|---|
| Build Timeout | 设置构建超时自动终止 |
| Publish Over SSH | 通过 SSH 部署到远程服务器 |
| SSH Credentials | SSH 密钥凭证管理 |
| Docker Pipeline | Pipeline 中构建和管理 Docker 镜像 |
| Kubernetes Plugin | 在 K8s 集群中动态调度构建代理 |
实用工具
| 插件名称 | 功能说明 |
|---|---|
| Folders Plugin | 任务分组管理，创建独立命名空间 |
| Rebuilder | 一键使用相同参数重新构建 |
| Timestamper | 构建日志中添加时间戳 |
| Coverage Plugin | 代码覆盖率报告展示 |
| Slack Notification | 构建结果推送到 Slack |
批量安装插件的方法
方法一：plugins.txt 文件
在 Jenkins 数据目录创建 plugins.txt，每行一个插件 ID：
git
pipeline
pipeline-stage-view
pipeline-graph-view
nodejs
role-strategy
localization-zh-cn
gitlab
ssh-credentials
ssh
build-timeout
credentials-binding
docker-workflow
timestamper
folder-plugin
rebuild
coverage
text
方法二：命令行安装
# 在 Jenkins 容器内执行
jenkins-plugin-cli --plugins git pipeline pipeline-graph-view nodejs role-strategy localization-zh-cn
bash
方法三：Dockerfile 预装
FROM jenkins/jenkins:lts
# 预装插件（需先配置加速源）
COPY plugins.txt /usr/share/jenkins/ref/plugins.txt
RUN jenkins-plugin-cli -f /usr/share/jenkins/ref/plugins.txt
dockerfile
总结
| 方法 | 难度 | 加速效果 | 推荐场景 |
|---|---|---|---|
| 管理界面配置 Update Site | 简单 | 中等（可能仅加速元数据） | 插件数量少，网络尚可 |
修改 hudson.model.UpdateCenter.xml | 简单 | 中等 | 配合 default.json 修改使用 |
修改 default.json 文件 | 中等 | 显著（彻底替换下载地址） | 插件数量多，需要批量安装 |
最佳实践：
- 先通过界面或修改
hudson.model.UpdateCenter.xml配置加速源 - 如果仍然下载缓慢，再用
sed命令替换default.json中的下载地址 - 两个方法可以叠加使用，效果最佳
- 如果某个源不可达（如清华源在某些移动网络下），切换到腾讯云或华为云等其他源
参考资料
↑